home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / gcp915.zip / GCP.TXT < prev    next >
Text File  |  1992-09-15  |  29KB  |  659 lines
  1. .* This file should be SCRIPTable without the need for any changes
  2. .* or any specific formatting options. It has been set up to be
  3. .* printer independent as much as possible.
  4. .pm 5
  5. .rc 1 |
  6. .hy off
  7. .ll 73
  8. :gdoc
  9. :frontm
  10. :titlep
  11. :title GCP: A Great Circle Program
  12. :address
  13. :aline Release 1.1
  14. :aline
  15. :aline May, 1989
  16. :aline
  17. :aline
  18. :aline
  19. :aline Garry Barker, VK5BUB
  20. :aline VNET SYDVM1(ABABARK)
  21. :eaddress
  22. .ri on
  23. :etitlep
  24. .ri off
  25. .ju on
  26. :preface
  27. :p.This program was written for the potential benefit of all
  28. amateur radio operators and may be distributed freely to anyone
  29. interested. No responsibility is taken by the author with regard to the
  30. accuracy, currency or usefulness of the program.
  31. .rc 1 on
  32. :p.The initial release of the program was an attempt to sample the
  33. usefulness or otherwise of the program and to judge the
  34. benefits of further development based on feedback (or lack of it)
  35. and so, it had a few niceties omitted.
  36. :p.The release discussed in this document (Release 1.1), incorporates
  37. the following enhancements:
  38. :ul compact
  39. :li.Some performance improvements through improved mathematics
  40. :li.A more consistent menu interface
  41. :li.Removal of a printing bug
  42. :li.Inclusion of degree marker numbers on the circumference
  43. of the printed circle
  44. :li.Ability for users to specify their own reference locations
  45. for inclusion on the printed map
  46. :li.Ability to exclude reference locations from the printed map
  47. :li.Ability to specify spacing of radial markers in both degrees
  48. and kilometres on displayed and/or printed map
  49. :li.Ability to exclude radial markers from displayed and/or printed map
  50. :li.Requirement for about 20K more memory (enhancement??)
  51. :eul
  52. .rc 1 off
  53. :p.All work was done using the author's own time and resources.
  54. The hardware included a PC1 with maths co-processor and
  55. colour graphics adaptor, with 640K of RAM and 1 hard disk.
  56. The printer used was a 4201 Proprinter.
  57. :p.The mathematics for distance and bearing calculations were taken
  58. directly from the :cit.ARRL Antenna Book, 14th edition, page
  59. 16-4.:ecit.
  60. :h5.Acknowledgments
  61. .rc 1 on
  62. :p.My thanks go to Garry Herden (VK5ZK), Hans Smit (VK5YX), Tony
  63. Stanciewicz and Chas Franks for their help in testing and timing
  64. the operation of the initial release of this program on their
  65. equipment. Thanks also to those who offered suggestions and other
  66. feedback on that release. It all gave me the incentive to produce
  67. this next release.
  68. .rc 1 off
  69. :toc
  70. :body
  71. .* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  72. :h1.GCP Overview
  73. :h2.Why a Great Circle Program
  74. :p.The VK5BUB Great Circle Program (GCP) was written as a tool for
  75. answering some questions I found myself asking, such as:
  76. :ul
  77. :li.How come I need to point a beam antenna due south from Adelaide
  78. to contact Brazil? All atlas maps show Brazil either north-east or
  79. north-west from Adelaide.
  80. :li.Why do I hear strong Japanese signals when they are beaming long path
  81. to Europe? Europe is "obviously" due west from Japan and Adelaide
  82. is due south.
  83. :li.How do I place my dipole so its major lobes favour
  84. the "best" directions?
  85. :li.Which signal paths lay over water?
  86. :li.What countries are better worked on the long path?
  87. :li.Why is it that I beam roughly north-west to Finland, but
  88. .rc 1 on
  89. Finnish
  90. .rc 1 off
  91. stations beam almost due west for Adelaide.
  92. :eul
  93. :p.I found I could get hold of great circle maps from several sources,
  94. but, in the true tradition of amateur radio, I wanted to be able to
  95. produce my own and so I took it up as a project.
  96. As with many projects, the program became a challenge and an interest
  97. for me and I was unable to find anyone who had such a program. There
  98. seemed to be programs to do one-at-a-time calculations of distance
  99. and bearing, but none to draw pictures.
  100. :p.In most instances, one would assume that the program would only
  101. be needed once and then discarded once a basic map had been
  102. printed. I suspect that the extra capabilities of GCP may make
  103. repeated usage likely, although its usage on a one-off basis by
  104. a few people would justify the effort to me.
  105. :h2.What the program does
  106. .rc 1 on
  107. :p.In essence,
  108. .rc 1 off
  109. GCP allows the user to specify the latitude and
  110. longitude of the centre of the circle and then
  111. :ul compact
  112. :li.draw a great circle map on a graphics monitor,
  113. :li.draw it and then print it, or
  114. :li.print without review on the screen.
  115. :eul
  116. The printed map in this
  117. .rc 1 on
  118. release, as for the previous release,
  119. .rc 1 off
  120. of the program spans
  121. 4 print pages giving a circle of roughly 40 cm (16 in.) diameter.
  122. The first 2 pages form the left half and the next 2 form the right
  123. half of the map. The map is constructed by joining the 2
  124. halves with glue in between the overlapping edges. See the section
  125. on printer paper alignment in the chapter on "Using the Great Circle
  126. Program" for a handy hint.
  127. :p.At user request, the map can include a graphical representation
  128. of the long path in the outer half of the circle with the short path
  129. section then being half scale. This is useful in reviewing which countries
  130. lie on a path all of its way around the globe.
  131. :p.The printed map also includes numbered markers for a selected
  132. set of locations to allow for easy identification of land masses
  133. where the great circle representation makes shapes appear
  134. distorted. At the bottom of the map is a legend for the
  135. markers in numeric and concurrently alphabetic order.
  136. .rc 1 on
  137. :p.In this release, the markers and legend may be suppressed at
  138. user option on the GCP menu. The particular locations to be used
  139. as markers may also be changed by the user by editing the locations
  140. source data file GCPLOCS.DAT. More on this later.
  141. .rc 1 off
  142. :h2.Required operating environment
  143. :p.GCP has been written at the most machine-independent level
  144. consistent with performance requirements. The lowest level
  145. interfaces used are at the BIOS level for physical printing
  146. and screen plotting.
  147. :p.Basic machine requirements are:
  148. :ul
  149. :li.IBM PC or compatible.
  150. .rc 1 on
  151. :li.Approximately 430K of memory if maps are printed, 160K otherwise.
  152. .rc 1 off
  153. This does not include memory needed for DOS, BIOS etc..
  154. :li.CGA or similar if maps are displayed,
  155. any other DOS-supported monitor otherwise.
  156. .rc 1 on
  157. Release 1.0 has been tested
  158. with CGA, EGA and VGA, the latter running in CGA mode.
  159. .rc 1 off
  160. :li.IBM Proprinter or compatible if maps are to be printed.
  161. Should work with IBM graphics printer. The printer must be LPT1.
  162. :li.Room for the .EXE file and GCPMENU.PAN on floppy or hard disk
  163. - approximately 80K. If the GCPLOCS.DAT file is used, it is accessed
  164. every time printing is performed. If the file is not found, defaults
  165. will be used, but if the drive is not ready, errors may occur.
  166. This file is approximately 1.5K as supplied (unmodified).
  167. :li.A maths co-processor is not needed, but provides a significant
  168. performance advantage.
  169. .rc 1 on
  170. (See appendix A for some performance measurements for Release 1.0).
  171. :li.Operating system - GCP Release 1.0 was tested with PC-DOS 3.2,
  172. PC-DOS 3.3 and MS-DOS 3.3.
  173. .rc 1 off
  174. :eul
  175. :h2.Required files
  176. :p.The following are the program files:
  177. :ul
  178. .rc 1 on
  179. :li.GCP.EXE - the program for usage with maths co-processor. It will
  180. either not execute, or run very slowly, if no co-processor
  181. is available.
  182. .rc 1 off
  183. :li.GCPA.EXE - the program for usage with the Alternate maths library
  184. ie. without the maths co-processor. It will ignore a maths co-processor
  185. if it is present.
  186. :li.GCP.SCR - the documentation in standard GML SCRIPT format, suitable for
  187. printing in virtually any SCRIPT environment
  188. (PC, host, 3800, 3820, 3287, 6670...).
  189. :li.GCP.LST - the documentation as a file to be printed to
  190. a PC printer
  191. .rc 1 on
  192. :li.GCPLOCS.DAT - the source file of reference marker locations. This
  193. may be modified by the user.
  194. :li.GCPMENU.PAN - this is the compiled menu format. It may not be
  195. changed by the user.
  196. .rc 1 off
  197. :eul
  198. .* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  199. :h1.Using the Great Circle Program
  200. :h2.Known bugs
  201. .rc 1 on
  202. :p.This release of the program has been released with no known bugs.
  203. However, it has